home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / cmscreatetfm.z / cmscreatetfm
Encoding:
Text File  |  2002-10-03  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ccccmmmmssssCCCCrrrreeeeaaaatttteeeeTTTTffffmmmm((((3333))))                      CCCCMMMMSSSS                       ccccmmmmssssCCCCrrrreeeeaaaatttteeeeTTTTffffmmmm((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cmsCreateTfm - creates a transform from a set of profiles
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ccccmmmmssss....hhhh>>>>
  13.  
  14.      iiiinnnntttt33332222 ccccmmmmssssCCCCrrrreeeeaaaatttteeeeTTTTffffmmmm ((((ccccttttxxxxtttt,,,, pppprrrrooooffffiiiilllleeeeCCCCoooouuuunnnntttt,,,, pppprrrrooooffffssss,,,, ccccmmmmmmmm,,,, ppppttttffffmmmm))));;;;
  15.      CCCCMMMMSSSSCCCCoooonnnntttteeeexxxxtttt ccccttttxxxxtttt;;;;
  16.      iiiinnnntttt33332222 pppprrrrooooffffiiiilllleeeeCCCCoooouuuunnnntttt;;;;
  17.      CCCCMMMMSSSSPPPPrrrrooooffffiiiilllleeee ****pppprrrrooooffffssss;;;;
  18.      iiiiccccSSSSiiiiggggnnnnaaaattttuuuurrrreeee ccccmmmmmmmm;;;;
  19.      CCCCMMMMSSSSTTTTffffmmmm ****ppppttttffffmmmm;;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _c_m_s_C_r_e_a_t_e_T_f_m uses a color manipulation module (CMM) to create a transform
  23.      out of a list of profiles.  The resulting transform is a sequential
  24.      execution of the algorithms implied by the individual profiles, starting
  25.      from the first profile and ending in the last profile.
  26.  
  27.      Different CMMs will produce different transforms from the same set of
  28.      profiles.  The transforms will yield different results when applied a
  29.      given set of pixels.  Application writers may wish to control which CMM
  30.      is used to create and apply a transform.  They may do so by specifying
  31.      the CMM's name with the _c_m_m parameter.  The list of supported CMMs is
  32.      returned from the command _c_m_s_G_e_t_C_m_m_L_i_s_t.  Application writers who have no
  33.      preference as to the CMM used may do one of two things. They may specify
  34.      that the system's default CMM be used by setting _c_m_m to
  35.      _C_M_S__U_S_E__D_E_F_A_U_L_T__C_M_M.  Each profile in the list _p_r_o_f_s may specify a
  36.      preferred CMM in its header.  If the application writer sets _c_m_m to
  37.      _C_M_S__U_S_E__P_R_O_F_I_L_E__C_M_M, then the CMS goes through the list of profiles from
  38.      last to first and lets each specified CMM try to build the transform.  If
  39.      the CMM can build the transform, the result is used, and that CMM will be
  40.      used to apply the transform.  If the CMM cannot build the tranform, the
  41.      next one in order will be tried. If not of the CMMs can build the
  42.      tranform, _c_m_s_C_r_e_a_t_e_T_f_m returns an error.  The reason the list is
  43.      traversed backward is that output devices tend to be at the end of the
  44.      profile list, and it is the profiles of output devices that tend to have
  45.      the most dramatic effects on a tranform.
  46.  
  47. EEEERRRRRRRROOOORRRRSSSS
  48.      CMS_OUT_OF_MEMORY
  49.                There is not enough memory available to create a transform.
  50.  
  51.      CMS_WRONG_DATA
  52.                The ctxt points to something that is not a context.
  53.  
  54.      CMS_BAD_INPLACE_CONVERT
  55.                We cannot build an inplace conversion for this transform.
  56.  
  57.      CMS_BAD_ENCODE
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccmmmmssssCCCCrrrreeeeaaaatttteeeeTTTTffffmmmm((((3333))))                      CCCCMMMMSSSS                       ccccmmmmssssCCCCrrrreeeeaaaatttteeeeTTTTffffmmmm((((3333))))
  71.  
  72.  
  73.  
  74.      CMS_BAD_CONTEXT
  75.  
  76.      CMS_TOO_MANY_CHANNELS
  77.                The CMM cannot support a tranform with the requested number of
  78.                channels.
  79.  
  80.      CMS_CMM_NOT_AVAILABLE
  81.                The requested CMM is not available.
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      cmsApplyTfm, cmsCreateGamutCheck
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.